home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3x / askillpid_server.z / askillpid_server
Encoding:
Text File  |  2001-04-17  |  4.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaasssskkkkiiiillllllllppppiiiidddd____sssseeeerrrrvvvveeeerrrr((((3333xxxx))))                                      aaaasssskkkkiiiillllllllppppiiiidddd____sssseeeerrrrvvvveeeerrrr((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      askillpid_server - send a signal to a remote process
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<aaaarrrrrrrraaaayyyyssssvvvvccccssss....hhhh>>>>
  14.  
  15.      iiiinnnntttt aaaasssskkkkiiiillllllllppppiiiidddd____sssseeeerrrrvvvveeeerrrr((((aaaasssssssseeeerrrrvvvveeeerrrr____tttt SSSSeeeerrrrvvvveeeerrrr,,,, ppppiiiidddd____tttt PPPPIIIIDDDD,,,, iiiinnnntttt SSSSiiiigggg))));;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _a_s_k_i_l_l_p_i_d__s_e_r_v_e_r sends a signal to the process PPPPIIIIDDDD.  Depending on the
  19.      server token SSSSeeeerrrrvvvveeeerrrr, PPPPIIIIDDDD does not necessarily have to reside on the same
  20.      machine as the one executing _a_s_k_i_l_l_p_i_d__s_e_r_v_e_r.  The signal that is to be
  21.      sent is specified by SSSSiiiigggg and is either one from the list given in
  22.      _s_i_g_n_a_l(2), or 0.  If SSSSiiiigggg is 0 (the null signal), error checking is
  23.      performed but no signal is actually sent.  This can be used to check the
  24.      validity of PPPPIIIIDDDD.
  25.  
  26.      The real or effective user ID of the sending process must match the real,
  27.      saved, or effective user ID of the receiving process, unless the
  28.      effective user ID of the sending process is superuser.
  29.  
  30.      The SSSSeeeerrrrvvvveeeerrrr argument specifies an optional array server token, which can
  31.      be used to direct the request to a specific machine.  If NULL is
  32.      specified instead, the request will be processed by the default array
  33.      services daemon (see _a_r_r_a_y(1) for more information on how the default
  34.      array services daemon is selected).  For more details on creating an
  35.      array server token, see _a_s_o_p_e_n_s_e_r_v_e_r(3X).
  36.  
  37.      _a_s_k_i_l_l_p_i_d__s_e_r_v_e_r will fail if one or more of the following are true:
  38.  
  39.      * SSSSiiiigggg is not a valid signal number
  40.  
  41.      * SSSSiiiigggg is SIGKILL and PPPPIIIIDDDD is process 1.
  42.  
  43.      * The user ID of the sending process is not superuser, and its real or
  44.        effective user ID does not match the real, saved, or effective user ID
  45.        of the receiving process
  46.  
  47.      * The array services daemon (_a_r_r_a_y_d) is not currently active on the
  48.        machine specified by SSSSeeeerrrrvvvveeeerrrr
  49.  
  50. NNNNOOOOTTTTEEEESSSS
  51.      _a_s_k_i_l_l_p_i_d__s_e_r_v_e_r is found in the library "libarray.so", and will be
  52.      loaded if the option "-larray" is used with _c_c(1) or _l_d(1).
  53.  
  54. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  55.      kill(2), aserrorcode(3X), askillash_server(3X), asopenserver(3X),
  56.      array_sessions(5).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaasssskkkkiiiillllllllppppiiiidddd____sssseeeerrrrvvvveeeerrrr((((3333xxxx))))                                      aaaasssskkkkiiiillllllllppppiiiidddd____sssseeeerrrrvvvveeeerrrr((((3333xxxx))))
  71.  
  72.  
  73.  
  74. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  75.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  76.      of -1 is returned and _a_s_e_r_r_o_r_c_o_d_e(3x) is set accordingly.
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.